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MOODS  DATA  MANAGEMENT  SYSTEM  USER’S  MANUAL 


1  SCOPE 

1.1  Identification 

Computer  Software  Configuration  Item  (CSCI):  Master  Oceanographic 

CX)servation  Data  Set  (MOODS)  I^tta  Management  System  (t^MS). 

Version:  1.0. 

Release  Date:  30  June  1994 

Contract  No:  NAS  13-330,  Order  No.  53 

Contractor:  Mississippi  State  University 
Center  for  Air  Sea  Technology 
J.  H.  Corbin,  Director 
Building  1 103,  Room  233 
Stennis  Space  Center,  MS  39529-6000 
Telephone;  (601)  688-2561 
Facsimile;  (601)  688-7100 

Project  Manager:  Ms.  Cheryl  (>sario,  Mississ4)pi  State  University 

Colter  for  Air  Sea  Technology,  Stennis  Space  Center,  Mississipin 
39529-6000.  (MSU  Proposal  No.  93-3-467) 

Telephone;  (601)  688-7141 
FacsimUe;  (601)  688-7100 


1.2  Overview 

The  MOODS  Data  Management  System  (MDMS)  provides  access  to  the  Master 
Oceant^r^ihic  Observation  Data  Set  (MOODS)  which  is  maintained  by  the  Naval  Oceanographic 
Office  ^AVOCBANO).  The  MDMS  incorporates  database  technology  in  providing  seamless 
access  to  parameter  (temperature,  salinity,  sound  speed)  vs.  depdi  observational  profile  data.  The 
MDMS  is  an  interactive  software  apfdication  widi  a  graj^cal  user  interface  (GUI)  that  supports 
usor  control  of  MDMS  functional  cap^ilities. 

1.2.1  Logical  Data  Overview 

The  MDMS  operates  exclusively  on  parameter  vs.  depth  observational  profiles.  These 
observations  consist  of  a  sequential  series  of  depdis,  accompanied  by  parameter  values  measured  at 
those  depths.  As  many  as  three  parameters  may  be  givra  for  the  indicated  depths  in  a  sequ^ce. 
Each  profile  is  preened  by  a  header  section  that  provides  location,  time,  and  other  useful 
information  for  classifying  the  observatiem.  This  header  informatiai  is  traditionally  referred  to  as 
“metadata”  and  serves  to  establish  the  criteria  which  may  be  ap{died  in  searching  and  qi^ing  the 
database  or  retrieving  profiles  from  the  database  that  conform  to  specific  omstraints. 


1.2.2  FuiMtionality  Overview 


The  MDMS  supports  user  defined  database  queries  and  searches  of  the  MOODS  database. 
The  MDMS  also  allows  profile  data  to  be  imported  from  exteraal  files  for  ingestion  into  the 
MOODS  database.  Conversely,  profile  data  resident  in  the  database  may  be  retrieved  and  written 
to  external  files.  Finally,  the  MDMS  provides  a  limited  suite  of  ^tabase  query  and  data 
visualizatitm  tools. 

1.23  Administrative  Overview 

MDMS  access  crnitrol  is  based  upon  a  hierarchy  of  classification  criteria.  The  MOODS 
database  exists  as  two  distinct  databases,  each  in  its  own  control  envircmment  with  separate 
installations  of  the  MDMS.  The  unclassified  MOODS  database  contains  bodi  public  domain  and 
restricted  data.  Hie  classified  database  contains  classified  data.  The  level  of  access  granted  to  each 
user  is  controlled  and  configured  by  the  MOODS  Database  Administrator  (MDBA).  Questions 
regarding  access  to  the  MDMS  should  be  addressed  to  the  MDBA. 

1.2.4  Support  Overview 

This  manual  represents  the  core  document  for  user  support  of  the  MDMS.  System 
specifications  are  described  in  the  MDMS  Design  Document  In  addition  to  this  manual,  refer  to 
documratation  for  proprietary  (commercial)  software  and  non-developed  (government  provided) 
software  (NDS)  which  are  integrated  into  the  MDMS.  These  integrated  software  items  are 
described  in  Aj^oidix  E  of  this  manud. 

1.3  Document  Overview 

This  is  die  final  MDMS  user’s  manual,  replacing  the  preliminary  documrat  provided  for 
sptnisor  review.  It  incorporates  modifications  made  prior  to  die  final  release  of  the  MDMS, 
version  1.0. 

1.3.1  References 

Documents  refermced  within  this  manual  are  listed  in  Section  2.  Where  referenced  in  die 
text,  die  document  name  is  followed  by  die  apprq^te  subparagraiA  number  of  Sectimi  2,  where 
complete  reference  informadon  may  be  fcHmd  Widiin  Section  2,  each  reference  is  foUowed  by  a 
pairaidi^cal  listing  of  paragraph  numbers  widiin  the  manual  wh^  die  refermce  is  cited. 

1.3.2  Format  and  Content 

The  fonnat  and  coitent  of  diis  manual  are  in  accordance  widi  Data  Item  Description  (DID) 
number  DI-MCCR-80019A  of  the  Department  of  Defense  (DoD)  Standard  2167A  “Defense 
System  Software  Development”  (2.1). 

1.3.3  Definitions  and  Conventions 

In  ordmr  to  simplify  and  standardize  communication  of  {vocedural  details  to  the  user,  this 
manual  incoiporates  die  following  definitions  and  conventions: 


Deflnitions: 

button  -  When  used  in  relation  to  the  mouse  device,  a  button  is  one  of  three  pressure 
switches  which  may  be  pressed  (clicked)  to  control  some  feature  of  the  screen 
display.  When  used  in  relation  to  the  monitor  display,  a  button  is  a  labeled  area  of 
the  on-screen  grafdiical  design  which  resembles  a  switch  which  can  be  activated  by 
pressure. 

click  -  The  act  of  pressing  a  button  on  the  mmise.  The  term  “click  cat”,  or  simply  “click”, 
is  fr^uendy  used  to  indicate  that  the  user  should  maneuver  die  mouse  cursor  to  a 
specified  location  on  the  screen  (usually  an  area  designed  to  resemble  a  button)  and 
p^s  (click)  the  af^iropnate  button  on  the  mouse. 

cursor  -  A  gra{^ical  symbol  that  identifies  a  position  on  a  computer  monitor  screen.  A 
cursor  is  sometimes  controlled  by  moving  a  mouse  device;  otherwise,  it  is 
controlled  from  the  keyboard,  usually  widi  the  arrow  keys. 

display  -  Syncaiyma^s  with  the  computer  monitor  screen;  also,  to  demonstrate  or  to  show. 

drag  -  The  act  of  pressing  and  holding  a  button  on  the  mouse  device  and  moving  the 
mouse  to  control  cursor  movement  on  the  monitor  screen.  The  purpose  of 
dragging  the  mouse  device  is  to  define  an  area  on  die  screen  or  to  move  a  gra^ical 
object  to  anodier  location  on  the  scre^. 

listbox  -  An  oudined  area  of  the  display  which  contains  two  or  more  rows  of  textual 
information.  Selection  of  text  wi&in  a  row  is  accomplished  by  placing  the  mouse 
cursor  over  die  row  and  clicking  an  appropriate  button  on  die  mouse. 

mouse  -  A  hand  controllable  device  used  to  interact  with  images  displayed  oa  the  computer 
monitor  screen.  When  a  mouse  is  moved,  a  curscn*  (»  die  screen  moves  in  the  same 
direction  as  the  mouse.  One  or  more  buttons  may  be  present  on  a  mouse  for 
invoking  an  action  (m  screen  at  the  corresponding  cursor  position. 

rubber  band  -  The  act  of  dragging  the  mouse  to  define  an  area  on  the  screen.  A  mouse 
button  is  press^  and  held  while  the  mouse  is  maneuvered  to  position  die  on-screen 
cursor  at  a  desired  final  position;  dien,  the  mouse  button  is  released. 

screen  -  The  display  surface  of  a  compute  video  monitor  ^ere  images  appear  in  respcmse 
to  bomtetdinait  by  electrons. 

scrollbar  -  The  grai^ical  image  of  a  narrow  bar  with  arrows  embedded  at  both  ends  and, 
sometimes,  a  movable  (sliding)  button  between  them.  The  scroll  bar  is  used  to 
positicxi  a  porticai  of  an  image  or  text  for  viewing  insitte  a  bound  area  that  is  smaller 
than  the  whole  inu^e  or  text.  Scrolling  is  accomplished  by  placing  the  mouse 
cursor  on  one  of  the  arrows  and  pressing  the  mouse  button.  Scrolling  may  also  be 
accomplished  by  placing  the  mouse  cursor  over  the  sliding  button  and  dnqgging  the 
sliding  button  to  a  new  position  along  the  scrollbar. 

textbox  -  an  outlined  area  of  the  display  which  contains  textual  information.  Text  in  a 
textbox  may  sometimes  be  e^ted;  however,  the  usual  purpose  of  a  textbox  is  to 
provide  information  to  the  user.  A  texdx)x  is  not  scrollable. 


window  -  An  outlined  area  of  the  screen  whose  contents  are  confined  to  the  outlined 
boundary  and  controlled  by  user  interaction  (with  buttons,  menus,  etc.)-  A 
window  is  usually  a  top  level  stnicture  closely  tied  to  the  operating  enviixmment  of 
the  comixiter. 

NOTE:  Additional  d^initions  are  axitained  in  Appendix  A. 

Keyboard  Entry:  Text  printed  in  UaUes  in  this  manual  repres^ts  information  which  is 
to  be  oiter^  via  the  keyboard  as  written  (usually  followed  by  pressing  die  rater  or  return  key). 

Mouse  Button  Convention:  Most  “click”  or  “select”  operations  with  the  mouse  use  the 
left  button.  Unless  otherwise  specified,  instructions  to  “click”  or  “select”  refer  to  the  left  mouse 
buttra.  When  a  “click”  or  “select”  operation  using  the  middle  or  n^t  mouse  button  is  requited,  the 
specific  mouse  button  will  be  indicated  in  the  text;  otherwise,  the  left  mouse  button  should  be 
assumed. 

2  REFERENCED  DOCUMENTS 

This  user’s  manual  either  1)  contains  references  to  the  following  documents,  or  2) 
suimnarizes  information  contained  in  Aem  which  is  ^ipropriate  for  fiitdi^  rea^g: 

2.1.  DoD  Standard  2167A  (DOD-STD-2167A)  “Defense  System  Software 
Develt^roraf*  of  29  February  1988,  AMSC  No.  N4327,  Department  of  Defense, 
Washington,  DC  20301.  (1.3) 

2.2.  Young,  Douglas  A.,  “The  X  Windows  System  Programming  and  Ai^lications  with 
Xt,  OSF/Motif  Edition”,  Prentice  Hall,  Englewood  Cliffs,  NJ,  1990. 

2.3.  Jurkevics,  Andrew,  ‘T)atabase  Design  Document  for  the  Naval  Environmental 
Operatiraal  Nowcast  System,  V^ion  3.5”,  Naval  Oceanographic  and  Atmospheric 
Research  Laboratory,  Monterey,  CA,  1  June  1992. 

2.4.  Documentation  (Series)  for  the  Empress  Relatiraal  Database  Management  System, 
Versira  6.X,  Vol.  Al-Dl,  Empress  Software  Incorporated,  Orerabelt,  MD,  1993. 

2.5.  Users  Manual  and  Reference  Guides  for  UNIRAS  ag/X  Toolmaster  Graphics 
Extensions  Library,  Version  6v3b,  UNIRAS,  Incorporated,  Overland  Park,  KS, 
1993. 

2.6.  Cofiin,  Stephen,  “UNIX  System  V  Release  4:  Ae  Complete  Reference”,  Osborne 
McGraw-Hill,  New  York,  NY,  1990. 

3  EXECUTION  PROCEDURES 

3.1  Initialization  (Launching  the  Application) 

The  MDMS  observes  Ae  standard  procedure  for  executing  an  application  in  Ae 
X-Wmdows  environment.  At  Ae  X-Windows  command  line  prompt,  enter  moods  [-f] 
[filename]  or  moods,  >f  filename  is  optional;  Ae  -f  flag  mAcates  Aat  Ae  next  parameter  is 
Ae  name  of  an  initialization  (configuration)  file.  If  only  moods  is  entered,  Ae  MDMS  will  look 
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for  the  “moods.defaults”  file  in  the  current  directory.  The  MDMS  main  display  will  appear  after 
initial  window  manager  procedures  ate  completed  (e.g..  If  using  “toms  window  manager”  - 
twmrc”,  a  window  siteleton  appears  on  screen  which  must  be  maneuvered  to  the  desired  positicxi 
on  the  monitor  screen  with  &e  mouse.  If  using  “motif  window  manager”  -  “.mwmrc”,  the 
posititm  of  die  main  display  is  predefined  and  t^pears  without  any  further  acticm  after  entering 
moods  fix>m  the  keyboa^  Odier  window  managers  may  involve  different  imx:edures  before  the 
main  display  ai^iears.). 

3J2  Initializatioii  Files 

Initialization  files  contain  default  settings  for  maximum  and  minimum  values  of  the  key 
search/query/ietrieval  parameters  required  by  the  MDMS.  Instructions  for  creating  initialization 
files  are  provided  in  Appendix  C.  Questions  regarding  implementaticm  of  initialization  files  should 
be  directed  to  the  MDBA.  If  an  initialization  fde  cannot  be  found,  (1)  textbox  displays  within  the 
“Selection  Status”  area  of  the  main  \fDMS  display  will  be  blank  (no  initial  values),  (2)  the 
message  “Error  Reading  £)efaults  FUe”  will  be  displayed  in  the  ‘"REMARK:”  textbox  at  bottom 
of  die  main  SCDMS  display  window,  and  (3)  the  SC1>MS  will  use  global  default  values  resident  in 
tl»  plication. 

3.3  Description  of  Display  Windows 

The  screen  displays  of  the  MDMS  are  X-Windows  clients.  Window  control  adheres  to 
standard  X-Windows  procedures.  As  illustrated  in  Figure  1,  the  opting  display  is  subdivided  into 
five  majtK*  areas:  (1)  title  area;  (2)  ""Data  Selectitm”  area;  (3)  ""Selection  Status”  area;  (4)  pull-down 
menu  and  (5)  the  ""REMARKS”  area.  The  function^ty  and  purpose  of  each  area  of  Ae  display 
is  describe  below  and  illustrated  in  Figure  1. 

3.3.1  Title  Area 

The  title  area,  which  occupies  the  top  fifth  (tqiproximately)  of  the  ^play,  has  no  purpose 
except  to  identify  the  application  as  the  ‘"NAVAL  0(5eAN0GRAPHIC  OFFICE  MOODS  DATA 
MANAGEMENT  SYSTEM”. 

3.3.2  Data  Selection  Area 

The  ‘"Data  Selection”  area  of  the  main  display  window  occupies  most  of  the  left  half  of  the 
display.  It  contains  7  smaller,  labeled  areas  for  setting  the  maximum  or  minimum  values  of 
ccH^guration  parameters  displayed  in  the  ‘"Selection  Status”  area  occupying  the  right  half  of  the 
display.  Parameter  ranges  are  effective  during  searches,  queries  and  retrievals  of  data  from  the 
MOODS  dambase.  To  set  a  parameter  value  witiiin  the  “Selection  Status”  area,  you  must  select  (or 
enter)  tiiat  parameter  using  the  interfaces  provided  witiiin  the  “Data  Selection”  area. 

3.3.2.1  Data  Selection  Area:  Classification  (Listbox) 

This  scrollable  listbox  ccxitains  NAVOCEANO  MOODS  classificaticm  codes.  These  codes 
may  be  selected  one  at  a  time  by  clicking  on  (selecting)  the  line  containing  the  desired  code, 
dassificatimi  codes  are  multi-digit  positive  integers  tiiat  control  and  restria  access  to  the  M(X)DS 
database.  Classification  codes  can  only  be  changed  by  the  MDBA.  Each  line  in  the 
“aassification”  listbox  contains  a  unique  code  followed  by  textual  information  describing  that 
code.  If  the  number  of  valid  codes  exceeds  5,  the  scrollbar  at  the  right  will  be  activated.  When 
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selected,  a  classificaticxi  code  is  copied  into  the  ‘Selection  Status”  area  of  the  main  display  window 
as  a  maximum  ca  minimum  value  adjacent  to  the  label  “Classification”. 


Figure  1.  MOODS  Data  Managemrat  System  (MDMS)  Opening  Display  Screen. 


3.3.2.2  Data  Selection  Area:  Instrument  Type  (Listbox) 

The  “Instrument  Type”  listbox  ccmtains  a  variety  of  instruments  known  to  be  employed 
the  collection  of  observational  data.  Instrument  types  are  positive  integer  codes  starting  with 
(unlmown)  and  can  only  be  selected  one-at-a-time.  Only  the  MDB  A  can  modify  instrument  types. 
If  the  number  of  valid  instrument  types  exceeds  5,  the  scrollbar  to  the  right  will  be  activated. 
Whai  selected,  an  instrument  type  is  copied  into  the  “Selection  Status”  area  of  the  main  display 
window  as  a  maximum  or  minimum  value  adjacent  to  the  label  “Instrument  Type”.  . 
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3.3.2.3  Data  Selection  Area:  Load  Date  (Textbox) 

The  ‘*Load  Date”  textbox  allows  entry  of  the  date  when  data  was  ingested  into  the  MOODS 
database.  The  user  must  enter  the  date  of  loading  in  a  continuous  year,  month,  day 
(YYYYMMDD)  format;  e.g.,  19920616  is  16  June  1992.  This  entry  will  be  copied  into  the 
“Selection  Status”  area  of  the  main  display  window,  as  a  maximum  or  minimum  value,  adjacent  to 
the  label  “Loading  Date”.  To  enter  a  load  date,  click  the  “Load  Date”  textbox  and  rater  the  date 
string  from  the  keyboard.  Text  entered  into  the  ‘Toad  Date”  texdx)x  may  be  edited  by  dragging  the 
cursor  to  hi^light  selected  characters  and  replacing  diem  using  the  keyboard. 

3.3.2.4  Data  Selection  Area:  Number  of  Parameters  (Scrollbar) 

The  “Number  of  Parameters”  is  set  via  a  small  horizontal  scrollbar  scale  ranging  from  2 
(left  boundary)  to  4  (right  boundary)  which  allows  the  user  to  specify  the  number  of  primary 
profile  parameters  ((tepth,  temperature,  salinity,  sound  speed)  involved  in  database  retrievals, 
searches  and  queries.  The  “Number  of  Parameters”  selection  is  reflected  in  the  “Selection  Status” 
area  under ‘Tarameters”.  The  scrollbar,  is  moved  by  dragging  with  the  mouse.  Deptii  is  always 
selected  as  a  primary  parameter;  hrace,  the  minimum  numbra  of  parameters  is  two.  The  number  of 
parameters  is  crxrelat^  with  the  MOODS  profile  stmcture  in  the  following  manner. 

Number  Paramsters 

2  depth  and  tempraiture 

3  depth,  tempmture  and  salinity 

4  depth,  temperature,  salinity  and  sound  speed 

3.3.2.5  Data  Selection  Area:  Source  Code  (Listbox) 

This  listbox  displays  numerical  codes  and  accompanying  information  about  the  sources  of 
data  contained  in  tiie  MOODS  database.  Source  identification  codes  are  positive  integers.  Only 
rae  source  code  can  be  selected  at  a  time.  Source  codes  are  copied  into  the  “S  election  Status”  area 
under  “Source  Code”.  If  more  than  5  source  codes  are  defined,  the  “Source  Code”  listbox 
beccxnes  a  scrollable  list  Source  codes  can  raly  be  changed  by  the  MDB  A. 

3.3.2.6  Data  Selection  Area:  Cruise  Id  (Textbox) 

The  “Cruise  Id”  textbox  allows  the  user  to  enter  a  cruise  identification  numbra  which  is 
automatically  copied  into  tiie  “Selection  Status”  area,  as  a  maximum  or  minimum  value,  adjacent  to 
the  label  “Cruise  Id”.  To  enter  a  cruise  identification  number,  click  the  “Cruise  Id”  texttox  and 
enter  the  number  from  the  keyboard.  Text  entered  into  the  “Cruise  Id”  textbox  may  be  edited  by 
drag^g  to  higbli^t  selected  characters  and  replacement  tiiem  using  the  keyboard. 

3.3.2.7  Data  Selection  Area:  Month  (Listbox) 

Ihe  “Month”  scrollable  listbox  displays  the  twelve  mraths  of  the  year.  The  month  selected 
will  be  the  lowra  (minimum)  or  upper  (maximum)  boundpy  of  the  desired  range  of  months  within 
tile  yea'.  The  month  select^  from  the  “Month”  listbox  is  copied  into  the  “Selection  Status”  area 
undra  “Month”  as  a  maximum  or  minimum  value. 
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3.3.3  Selection  Status  Area 


The  “Selection  Status”  area  contains  a  matrix  of  textboxes  which  displays  minimum 
(leftmost  column)  and  maximum  (rightmost  column)  values  for  each  labeled  criteria  (row).  The 
two  top  rows  (“Latitude”  and  “Longitude”)  are  set  by  selecting  “Region”  from  the  “SELECT” 
pull-down  menu  (see  subpara.  3.3.4.1.1).  The  third  row  (‘Time”)  values  are  set  by  selecting 
‘Time”  from  die  “SELECT”  pull-down  menu  (see  subpara.  3.3.4. 1.2).  The  remaining  rows  of 
minimum  and  maximum  values  are  set  from  within  the  “Data  Selection”  area,  accessing  each 
labeled  criteria  once  to  modify  the  minimum  value  (leftmost  column)  and  once  to  modify  the 
maximum  value  (rightmost  column).  “Selection  Status”  textboxes  cannot  be  edited.  Each 
textbox  in  the  **Selection  Status**  area  must  contain  a  value;  otherwise,  the  MDMS 
will  not  initiate  a  search  of  the  MOODS  database. 

3.33.1  Selection  Status  Area:  Default  Values 

Whoi  launched,  minimum  and  maximum  parameter  values  displayed  in  “Selection  Status” 
textboxes  are  obtained  by  reading  an  initialization  file  containing  default  values.  Unless  the 
initializaticMi  filraame  (and  path)  is  included  in  the  command  line  following  the  “-f”  flag,  the 
MDMS  will  look  for  a  file  named  “moods.defaults”  in  the  current  directory.  Users  and/or  the 
MDBA  may  tailor  dieir  own  initialization  files  (see  Appradix  C  for  an  example  and  instracticHis  on 
creating  user  initialization  files).  If  an  Initialization  file  cannot  be  found,  “Selection  Status” 
textboxes  will  not  be  initialized  widi  entries  at  startup. 

3.33.2  Selection  Status  Area:  Minimum  and  Maximum  Toggles 

Each  column  within  the  “Selection  Status”  area  is  headed  by  a  toggle  button  -  “Minimum” 
above  the  leftmost  column,  and  “Maximum”  above  the  rightmost  column.  Each  button  may  be 
alternately  toggled  (activated  and  deactivated)  by  successive  clicks.  When  activated,  these  buttons 
are  red;  when  inactive,  they  are  displayed  in  a  shade  of  the  background  color.  When  the 
“Minimum”  toggle  is  active  (red),  all  mo^caticms  perfonned  in  the  “Data  Selection”  area  affect 
the  “Minimum”  column.  The  “Maximum”  toggle  buttcm  evokes  tire  same  behavior  in  the 
“Maximum”  column.  If  no  toggle  buttcm  is  active,  any  selections  from  the  “Data  Selection”  area 
will  default  to  die  “Minimum”  column. 

3.3.3.3  Selection  Status  Area:  Latitude  and  Longitude  Values 

In  the  “Selection  Status”  area,  a  south  latitude  or  a  west  longitude  are  given  as  negative 
values.  North  latitude  and  east  longitude  are  displayed  as  positive  values  (plus  sign  understood). 
Values  for  latitude  and  longitude  are  expressed  in  decimal  degrees;  e.g.,  37  degre^,  43  minutes  is 
displayed  as  37.716666  (degrees).  The  6-decinial  accuracy  offers  precision  in  increments  of 
0.364567  feet  (43748  inches),  or  to  the  nearest  milliontii  of  an  arc  degree  (0.00006  nautical  mile). 
Latitude  and  longitude  values  may  be  set  by  reading  default  values  from  an  initialization  file  or  by 
using  tile  “Re^on”  opticm  available  from  tiie  “Select”  pulldown  menu. 

33.3.4  Selection  Status  Area:  Time 

Maximum  and  minimum  times  are  expressed  as  YYYYMMDD:HH:mm:SS,  where  YYYY 
is  tile  year  (four  digits),  MM  is  montii  (1-12),  DD  is  day  of  the  month,  HH  is  the  whole  hour  (00 
throu^  23),  mm  is  the  minute,  and  SS  is  the  second.  This  format  is  consistent  with  the  format 
used  ^  “Load  Date”  with  the  addition  of  hour/minute/second  time  resolution.  Time  values  may 
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be  set  by  reading  default  values  from  an  initialization  file  or  by  using  die  ‘Time”  option  available 
finm  the  “Select”  pulldown  menu. 

3.3.3.5  Selection  Status  Area:  Loading  Date 

Maximum  and  minimum  loading  dates  are  expressed  as  YYYYMMDD,  wh^  YYYY  is  the 
year  (four  (Ugits),  MM  is  month  (1-12),  and  DD  is  day  of  the  month.  The  “Loading  Date”  format 
is  consistent  with  the  format  used  for  ‘Time”.  “Load  Date”  values  may  be  set  by  reading  default 
values  from  an  initialization  file  or  by  using  the  ‘Toad  Date”  textbox  within  the  “Data  Selection” 
area. 


3.3.4  Menu  Bar 

The  pull-down  menus  are  accessed  by  clicking  the  labeled  menu  header  buttmis  in  die  menu 
bar.  Subon^ate  menu  items  are  then  displayed  as  ^iditional  labeled  buttons  below  the  top-level 
(header)  button.  Hie  user  may  select  a  moiu-item  by  clicking.  When  a  pull-down  menu  item  is 
selected,  a  window  will  usually  open  to  reveal  pertinent  options.  Whra  pi^-down  menu  items  are 
visible,  they  may  be  closed  by  cliddngl  in  a  neutral  area  of  the  MDMS  display  window  or  by 
clicking  anther  meavi  header  button. 

33.4.1  SELECT  (Menu  Header) 

The  “SELECT”  pull-down  menu  button  is  die  leftmost  button  in  die  menu  bar.  “SELECT“ 
offers  optimis  for  defining  r^onal  boundaries  (TlegioD”),  time  constraints  (“Time”)  and  to  ‘Exit” 
from  the  MDMS. 

33.4.1.1  SELECT:  Region 

Clicking  the  button  qpras  a  “REGION  SELECTION”  window  which  permits 

definitimi  of  geogrqihic  r^cm  boundaries.  The  “R^HON  SELECTION”  window  is  illustrated  in 
Figure  2.  Informatimi  d^ned  within  this  window  is  coined  into  die  “Latitude”  and  “Longitude” 
textboxes  withk  the  “Selectitm  Status”  portion  of  die  main  display.  The  “REGION  SELECTION'’ 
whidow  supports  duee  mediods  of  defining  latitude/lon^tude  boundaries: 

(1)  Predefined  Region:  Select  a  predefined  regicm  by  clicking  on  a  named  regitm  in  the 
scrollable  “REGION  LIST”  listbox.  The  named  regicm  will  dioa  be  displayed  for  inspection  as  a 
dashed  rectangular  boundary  in  the  map  display  in  die  right  of  die  window.  Predefu^  r^ons 
can  only  be  modified,  added,  or  dele^  by  the  MDBA. 

(2)  Keyboard  Entry:  Define  a  region  by  selecting  “REGION  CCX)RDINATES”  texdxixes 
and  entering  (via  the  keyboard)  latitude/longitude  coordinates  of  the  northeast  and  southwest 
comers  of  a  geographic  region.  Note  that  latitude  and  longitude  entries  in  “REGION 
CO(®DINATES”  textboxes  are  given  in  N,  E,  S,  W  notation;  whereas,  in  the  “Selection  Status” 
area  of  the  main  MDMS  display  south  latitude  or  west  longitude  are  displayed  as  n^ative  values 
and  north  latitude  or  east  longitudes  are  displayed  as  positive  values  (plus  sign  understood). 

(3)  Rubber  Band:  Define  a  region  by  drying  die  mouse  cursor  from  an  initial  position  oa 
die  map  display  to  a  final  position.  The  defined  regirxi  appears  on  the  map  display  as  a  rectangi^ 
area  bound^  by  dashed  lines.  When  the  cursor  lies  widtin  the  map  display  boundary,  its  position 
is  displayed  as  latitude/longitude  coordinates  in  the  ‘TAT:”  and  ‘TON:”  textboxes  located  below 
die  map  display.  Vertical  and  horizontal  scrollbars  allow  positioning  of  die  map  (hsplay.  When 
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clicked,  the  ^‘Zoom”  button  located  below  the  map  display  opens  a  window  which  displays  an 
enlarged  view  of  the  defined  region.  The  rubb^  band  technique  may  be  reapplied  within  &e  zoom 
Viwdow  to  refine  the  desired  geogiai^  area  (Note:  “LAT.”  and  “LON”  textooxes  below  the  nuq) 
display  do  not  reflect  cursor  coordinates  within  the  “Z(X)M'’  window.).  The  *‘Zoom”  buthm  will 
also  eMarge  geogrr^c  regitms  ctefined  within  the  zoonted  window.  To  close  toe  zoom  window, 
click  light  mouse  button  within  toe  zoom  window  boundary.  The  coastline  depicted  on  the 
map  disftoiy  is  composed  of  pleated  points  ratoer  than  ccmnected  lines  in  a  design  effort  to  optimize 
coastline  plotting  speed.  At  sufficiently  high  zoom  resolution,  toe  coastline  will  become  ill- 
(tefined. 

The  pull-down  ‘Tile”  menu  header  contains  options  to  “RESET”  toe  region  coordinates  to  default 
values  as  listed  in  toe  “Selectitm  Status”  area  and  to  ‘Txit”  toe  “REGION  SELECJnON”  window. 
Whai  finished  with  toe  “REGION  SELECTION”  window,  click  toe  ‘Tile:  EXIT”  pull-down  menu 
item  to  close  the  window  and  update  the  “Latitude”  and  “Longitude”  textboxes  within  the 
“Selection  Status”  area  of  tiie  main  MDMS  di^lay. 


Figure  2.  REGION  SELECTION  Window 


3.3.4.1.2  SELECT:  Time 

Whoi  tile  “Tune”  menu-item  button  is  click^  a  “TIME  SELECTION”  window  op^s  for 
definmg  minimum  and  maximum  date  and  time  limits.  Date  and  time  limits  defined  in  toe  “TIME 
SELEC^ON”  window  are  reflected  in  toe  ‘Tune”  criteria  row  within  toe  “Selection  Status”  section 
of  the  main  di^lay.  The  “TIME  SELECTION”  window  is  illustrated  in  Figure  3. 

Entering  Date/Time  Information:  The  “TIME  SELECTION”  window  allows  setting 
of  “START”  (minimum)  and  “END”  (maximum)  dates  and  times  for  database 
search/qu^/retrieval  operatiems.  Clicking  on  the  diamond-shaped  “RESET’  button  places  default 
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date/tune  comixxients  in  die  active  “START’  or  “END”  row  of  date/time  element  texttx)xe&  A  row 
of  date/time  component  textboxes  is  selected  by  clicking  on  the  diamond-shaped  button  adjacent  to 
the  “START’  or  “END”  label.  When  active,  the  “START”  and  “END”  buttims  are  displayed  in 
red,  and,  the  button  and  label  area  is  outlined  by  a  rectangle.  Textboxes  in  the  active  row 
(“START”  or  “END”)  may  be  edited  from  tite  keyboard  v^iiai  selected.  The  “HOUR”,  “MIN”  and 
“SEC”  textboxes  display  hours,  minutes  and  seconds  in  “hh:mm:ss”  format,  where  “hh”  is  the 
number  of  hours,  “mm”  is  the  number  of  minutes,  and  “ss”  is  the  number  of  seconds.  Date  entries 
may  also  be  changed  using  the  up  or  down  arrow  switch  buttons  to  the  right  of  the  “YEAR”, 
“MONTH”,  “DAY”,  and  “JULIAN”  textboxes.  These  arrow  switches  are  manipulated  by 
clicking. 


Figure  3.  TIME  SELECTION  Window 


3.3.4.1.3  SELECT:  Exit 

Clicking  the  “Exit”  maiu-item  closes  tiie  MDMS  main  display  screen  and  returns  tiie  user 
to  tiie  system  command  line  prompt 

3.3.4.2  MDBA 

The  “MDBA”  pull-down  mrau  contains  qitimis  to  “Import”  and  “Export”  data  to/firom  the 
MOODS  database.  It  also  contains  an  “Update  Table”  optimi.  The  and  *^pdate 

Tabte^  options  are  available  only  to  the  MOODS  ^tabase  Administrator  (MDBA) 
user  account. 


33.4.2.1  MDBA:  Import  (MDBA  Only) 

Sdecting  the  option  from  tiie  “MDBA”  pull-down  mrau  has  no  effect  unless  you 

are  tiie  MDBA.  Whra  the  “Import”  menu  item  is  selected  from  the  “MDBA”  puU-down  mrau,  tiie 
“Input  File”  p^Hip  win<k>w  (Figure  4)  ^qiears  for  entering  the  filraame  (with  pathname,  if  the  file 
is  not  located  in  the  cunmit  directory).  To  be  imported,  the  file  must  be  in  the  MOODS  ADMIN 
format  After  entering  the  filename  from  the  keyboard,  click  the  “OK”  button  to  import  the 
MOODS  data  from  the  named  file.  If  the  file  cannot  be  located,  the  dialog  window  will  close 
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autixiiatically  and  a  message  will  be  seat  to  the  *1^MARKS”  texttwx  in  die  main  MDMS  display. 
Clicking  the  **Cffiicer  buttcm  closes  die  dialog  window  without  importing  from  the  named  file. 


Figure  4.  MDBA  Filoiame  Entry  Ehalog  Window  for  Importing  Files 


33.4.2.2  MDBA:  Export 

When  die  *^pott”  menu  item  is  pressed  from  the  “MDBA”  pull-down  menu,  two  eiqxiit 
format  choices  appear  to  the  right  of  the  [xilldown  menu  -  “Export  Admin”  (for  MOODS 
Administrative  Format)  and  **Ex]^  Ideas”  (fOT  Interactive  Data  Analysis  System  Format).  A 
dialog  window  (Figure  5)  appears  for  altering  a  filename  after  ddio’  frnmat  is  selected.  After 
entering  die  fileiiatne  from  the  loeybr^  (including  the  path  if  the  file  is  to  be  written  to  a  directory 
other  t^  the  currmt  directory),  click  tte  “OK”  button  to  expnt  the  MOODS  data  to  the  named 
file.  If  the  file  cannot  be  written,  the  “Export”  dialog  window  closes  and  an  error  message  is  salt 
to  die  “Ronaiks”  section  ef  the  main  MDMS  dismay. 


Figure  5.  MDBA  Filename  Entry  Dialog  Windows  for  Exporting  Data  to  Files  Gefi  window  is  for 
N^ODS  ADMIN  format;  right  window  is  for  IDEAS  format) 

33.433  MDBA:  Update  Table  (MDBA  Only) 

Selecting  qitions  within  die  ’^Update  Table”  moiu  item  from  d^  “MDBA”  puU-down  moiu 
has  no  effect  unless  you  are  the  MDBA.  When  selected,  the  “Update  Table”  menu  item  (Usplays 
duee  qitiais:  “update_inst”,  “update.source”  and  ‘lipdatejclass”.  These  (^(ms  alk>w  the  MDBA 
to  updke  information  list^  in  the  “Instrument  Type”,  “Source  Code”  and  “Qassification” 
listboxes  in  the  ‘Data  Selection”  area  of  the  main  MDMS  display. 

33.4.23.1  MDBA:  Update  Table  -  update_iiist  (MDBA  Only) 

When  selected,  the  “update_inst”  menu  item  displays  the  “UPDATE  INSTRUMENT” 
window.  As  illustrate  in  Fi^re  6,  this  window  allows  new  instrument  code  numbers  and 
descriptirms  to  be  added  to  the  listing  of  instruments  displayed  in  the  “Instrument  Type”  scrollable 
listbox  in  the  ‘Data  Selection”  area  of  the  main  MDMS  display.  Existing  entries  can  be  edited  or 
deleted.  The  “Instniment  Number”  and  Instrument  Description”  textboxes  can  be  cleared  and  the 
scrollable  “Instrument”  lisdx)x  can  be  returned  to  its  oigi^  state  by  clicking  the  “Resa”  buttoi. 
The  “UPDATE  INSTRUMENT”  window  can  be  closed  by  clicking  tiie  “Exit”  buttoi. 
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a.  To  add  a  new  entry  to  the  “Instrument  Type”  textbox,  (1)  select  the  “Instrument 
Number”  textbox  and  enter  the  appropriate  instrument  number,  (2)  select  the  “Instrument 
Descr4)Cion”  textbox  and  enter  die  ^appropriate  descriptive  informatimi  and  (3)  click  the  “Add” 
butt(». 


b.  To  edit  an  existing  oitry  in  the  “Instrument  Type”  textbox,  (1)  select  the  instrument 
from  the  listing  in  die  scrollable  “Instruments”  texdxix,  (2)  make  chmges  to  the  instrument 
informadtm  displayed  in  die  “Instrument  Number”  and  “Instrument  Descriptitm”  textboxes  using 
the  mouse  and  ka^board  and  (3)  click  the  “Update”  button. 

c.  To  delete  an  existing  entry  from  the  “Instrument  Type”  textbox,  (1)  select  the 
histrument  to  be  deleted  in  die  “histrument”  window  and  (2)  click  die  “Delete”  button. 


Figure  6.  MDBA  Update  Instrument  Window 


33A,23,2  MDBA:Update  Table  -  apdate_source  (MDBA  Only) 

When  selected,  the  “update_souice”  menu  item  displays  the  “UPDATE  SOURCE” 
window.  As  iUustiated  in  Figure  7,  this  window  allows  new  source  numbers  and  descripdmis  to 
be  added  to  die  listing  of  data  sources  in  the  “Source  Code”  listbox  of  die  “Data  Selection”  area. 
Existing  mitries  can  be  edited  or  deleted.  The  “Source  Number”  and  '^Source  Description”  text 
entry  boxes  can  be  cleared  and  the  “Source”  scrollable  listbox  can  be  returned  to  its  (xiginal  state 
by  clicking  die  **Reset”  buttmi.  The  “UPDATE  SOURCE”  window  can  be  closed  by  clicking  the 
“Exit”  button. 


a.  To  add  a  new  entry  to  the  “Source  Code”  textbox,  (1)  select  the  “Source  Number” 
text  entry  box  and  entm*  the  af^opriate  source  number,  (2)  select  the  “Source  Description”  text 
mtry  box  and  enter  the  approgr^  desci^ve  infcmnatioa  and  (3)  click  die  “Add”  buttmi. 

b.  To  edit  an  existing  entry  cmitained  in  the  “Source  Code”  textbox,  (1)  select  the 
source  from  the  listing  in  the  scrollable  “Source”  textbox,  (2)  make  changes  to  die  source  code 
infonnadmi  displayed  in  die  ^'Source  Number”  and  “Source  Descriptimi”  text  ratty  boxes  and  (3) 
click  die  ‘TJpd^”  button. 
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c.  To  delete  an  existing  entry  from  the  “Source  Code”  textbox,  (1)  select  die  source  to 
be  ddeted  firom  the  “Source”  aindow  and  (2)  clkk  the ‘T)elete”  button. 


Figure  7.  MDBA  Update  Source  Window 
3J.4.23.3  MDBA:  Update  Table  -  apdate_class  (MDBA  Only) 

When  selected,  the  “update.class”  mrau  item  display  the  “UPDATE  CLASS”  window. 
As  illustrated  in  Figure  8,  diis  window  allows  new  classification  number  codes  and  descrqMions  to 
be  added  to  die  listing  of  classification  codes  displayed  in  the  “CTassification”  listbox  widiin  the 
*T)ata  Selection  area.  Existing  entries  can  be  edited  or  dek^ed.  The  “(3ass  Number”  and  “Class 
Description”  text  entry  boxes  can  be  cleared  and  die  “Classification”  lisdiox  can  be  returned  to  its 
original  state  hy  clicldng  die  “Reset”  button.  The  “UPDATE  CLASS”  window  can  be  closed  by 
clicking  the  *Ent”  Ixitton. 

a.  To  add  a  new  entry  to  the  “Qassificatkm”  textimx,  (1)  sdect  the  Xlass  Numbo:”  text 
entry  box  and  ester  die  i^^priale  classification  number,  (2)  select  die  “Class  Description”  text 
oitiy  tox  and  enter  the  appropriate  descr^itive  information  and  (3)  dick  die  “Add”  butttm. 

b.  To  edit  an  existing  entry  contained  in  die  '‘Classification”  textbox,  (1)  select  the 
classification  information  line  from  die  “Classification”  textbox,  (2)  make  changes  to  the 
classification  information  displayed  in  the  “Class  Nundier”  and  “Class  Description”  text  ratry 
boxes  and  (3)  click  die  “Updde”  button. 

c.  To  delete  an  existing  entry  from  the  “Classification”  texdxix,  (1)  select  the 
classification  infcxmation  line  from  the  “Classification”  textbox  and  (2)  elide  the  “Ddete”  buttem. 
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Figine  8.  MDB A  Update  Qassification  Window 

33.43  PRODUCTS 

Die  *TR(H>UCTS’’  pull-down  menu  offers  six  options.  The  ‘^Distribution”  menu  item 
allows  the  user  to  examine  ti»  location  of  individual  profiles  widiin  the  group  of  profiles  found  in 
die  database  search  process.  The  ‘DepA  Vs  Farm”  mrau  item  8upp(»t$  {dotting  [irofile  data  as  a 
function  of  dqxh.  ‘Ten^)  Vs  Saltnity”  menu  item  allows  die  usor  to  view  temperature  versus 
salinity  plot  wtim  bodi  panuneters  are  available.  The  *Tiint  Header”  menu  item  allows  dis{day  of 
header  information.  eiAer  on  the  screen  or  as  printer  ouQwL  The ‘Trint  Log”  menu  item  su{>ports 
review  of  historical  procedures  activity  keyed  to  the  various  functions  available  widiin  the  MDMS . 
The  ‘Page  Summary”  menu  item  dt^ys  or  {rats  a  summary  of  observation  (hstributions  by  year 
and  mondis  widiin  die  year  and  also  the  ^tributions  by  source  code,  instrument  code  and 
classifications. 

33.4.3.1  PRODUCTS:  Distribution 

When  die  uso*  clicks  die  “Distribution”  menu  itra.  a  ‘Distribution  Plot”  definitimi  window 
i^ipears  as  tiiown  in  Figure  9.  Distributitm  plots  are  omstructed  using  a  grid  of  latitude/longitude 
rectangles  ubose  size  (mesh  distance)  is  ^termined  by  values  entned  into  the  “Latitude”  and 
‘Ixmgitude”  textboxes.  Resdtition  of  the  coastline  for  geographic  plots  is  also  selectable  (3, 8,  or 
20  kUometms)  from  the  “Coast  Line”  pull-down  menu  (note:  The  textbox  adjacent  to  the  “Coast 
Line”  menu  header  may  be  selected  and  edited  direcdy  from  the  keyboard  to  change  coastline 
resolution.).  The  usn  can  choose  between  “Screen”  (defuilt)  and  *Trinter”  ou^t  by  toggling  the 
bott(»  provided  for  diat  purpose.  Profile  disdibutkm  may  be  viewed  as  two  types  of  geogra^ctd 
{dots  CDistiibution”  and  “Accumulation”)  or  as  a“Histogram”  by  clicking  d»  appn^nately  labeled 
button.  The  *Tbtel  Size”  sliding  scale  {xraits  variatimi  of  the  size  of  the  plotted  location  {xiint  on 
the  geogn^ic  background.  “Pixel  Size”  has  no  effect  on  the  histogrra  plot.  When  grid 
dimensimis.  coastlme  resolution  and  ouQxit  features  have  \xea  defined,  clicking  “Ok”  will  {xoduce 
tile  tqipfopriate  display  window.  Figure  10  illustrates  the  “Accumulaticxi  Plot  with  Instrument 
Symbols”  window  which  is  {xoduced  after  clicking  the  “Accumulation”  buttoi  in  the  ‘Distributicm 
Plot”  window.  Clicking  the  “Distribution”  button  produces  a  similar  geogra{ducal  plot  without 
printing  tiie  count  of  profiles  within  each  latitudeAcmgitude  rectangle.  Figure  1 1  is  an  exan^ile  of 
tile  tiiree-dimensitxial  “Histogram  Distribution”  plot  prc^ced  by  clicking  the  “Histogram”  button 
in  tile  “Distributicm  Plot”  win^w.  Wbra  finish^  viewing  the  plot,  click  anywhere  in  the  plotting 
window  to  close  it  To  exit  the  “Distributicxi  Plot”  window,  click  ^  ‘^xit”  button. 


My  DItliMiiMliiiI 

Figure  9.  Distribution  Plot  Definitkn  Window 


Figure  10.  Profile  Di^butkn/Accumulation  Plot  Window 
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Hguie  11.  Histogiam  Plot  of  Profile  Distributi(» 

33.4.3.2  PRODUCTS:  Depth  Vs.  Farm 

Wbra  the  *^Depth  Vs  Paim”  menu  item  is  clicked,  an  adjaceot  pulldown  mmiu  ai^)ears 
offering  a  choice  amcxig  throe  depth  versus  parameter  plots:  Depth  vs.  Temperature;  Depdi  vs. 
Salinity;  and  Depdi  vs.  Sound  Speed.  For  each  opdmi,  a  depA  vs.  parm  definition  window 
appears.  Figure  12  illustrates  the  ^pdi  vs.  temperanro  window,  whidi  is  labeled  ‘Temperature” 
(7^  depdi  vs.  salinity  and  depth  vs.  sound  sp^  definiticm  windows  are  labeled  “Salinity”  and 
“Sound  Speed”,  respectively;  otherwise,  they  are  identical  in  appearance  and  fimcticmality  to  the 
depth  vs.  temperature  window).  The  depdi  vs.  parameter  definition  window  ccmtains  textboxes  for 
(mtiy  of  minimum  and  maximum  values  for  the  x  and  y  axes  (“XAxis  Min”,  “XAxis  Max”,  “YAxis 
Max”  and  “YAxis  Max”)  and  the  maximum  number  of  jm^es  to  plot  (“Max  Profiles”).  these 

values  have  been  enter^  you  may  choose  to  (a)  plot  the  depA  vs.  parameter  graph  within  a 
window  (on-screen)  or  (b)  to  print  die  gr^  on  a  printer  by  haling  the  “Screen/Printer”  buttcm. 
When  ymir  choices  have  been  defined,  click  the  “OK”  butUm  to  pro^ce  die  plot  To  close  the  cxi- 
screen  plotting  window,  click  anywhere  within  its  boundaty.  Click  the  “Exit”  buttcm  to  close  the 
“Depdi  Vs  Parm”  window  and  return  to  the  main  display  window.  Figure  13  illustrares  a  depdi  vs. 
temperature  plot  which  is  similar  to  plots  produced  by  tte  odim*  two  options  (depth  vs.  salinity  and 
depth  vs.  sound  speed). 
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Fig^Ie  12.  Depth  ys.  Temperatuie  Defmitkm  Window 


Figure  13.  Depth  vs.  Temperature  Plot  Example 


33.4.3.3  PRODUCTS:  Temperature  vs  Salinity 

When  the  ‘Temperature  vs  Salinity”  menu  item  is  clicked  a  similar  window  to  temp  vs 
depth.  Figure  12,  a{^)eais.  The  temp  vs.  salinity  definition  winckiw  contains  textboxes  for  ent^  of 


minimum  and  maximum  values  fco’  the  x  and  y  axes  (“XAxis  Min”,  “XAxis  Max”,  “YAxis  Max” 
and  “YAxis  Max”)  and  the  maximum  number  of  profiles  to  plot  (“Max  Profiles”).  Once  these 
values  have  been  entered,  you  may  choose  to  (a)  [dot  the  temp  vs.  salinity  gn^  within  a  window 
(on-screcm)  or  (b)  to  print  the  gra[di  on  a  printer  by  toggling  the  “Screen/Printer”  butttm.  When 
ymir  choices  have  bem  defined,  cUck  die  “OK”  budon  m  pn^ce  die  plot  To  close  du  cm-scieen 
plotting  window,  click  anywhere  within  its  boundary.  Click  the  “Exit”  button  to  close  the  ‘Temp 
Vs  Sanity”  window  and  return  to  the  main  display  window.  A  window  similar  to  Figure  13 
displays  Salinity  vs.  Tempmtuie  plots. 

33.43.4  PRODUCTS:  Print  Header 

The  “Print  Header”  mitput  selection  window.  Figure  14,  a[^)ears  when  the  “Print  Header” 
menu  item  is  selected  from  the  “Products”  pull-down  menu.  This  window  presents  diamond¬ 
shaped  buttmis  for  selecting  either  “Screen”,  “Printer”  or  ‘Tile”  as  the  output  target.  Only  one 
optical  may  be  selected  at  a  time.  After  selecting  the  ou^t  target,  click  die  “(]&”  buttcm  to  produce 
a  listing  of  profile  headers  on  the  target  output  device.  If  “Screoi”  is  the  selected  option,  ou^t  is 
directed  to  a  text  window  on  screen.  The  header  display  window  may  be  closed  by  selecting  its 
“Close”  optical  from  the  X-Windows  unlabeled  pull-clown  mmu  located  in  das  upper  left  ccaner  of 
the  window  bender.  The  text  window  display  contains  output  from  the  UNIX  “vi”  editor.  It 
responds  to  all  “vi”  commands.  If  “Printer”  is  the  selected  o^on,  a  paper  [aintout  of  the  header 
informatiem  is  produced  by  the  default  printer.  To  ensure  printout  of  foil  lines,  the  default  printer 
should  be  capable  of  136  character/line  output.  If  “FUe”  is  the  chosen  option,  the  header 
infcmnaticai  is  written  to  a  user  specified  file  as  defined  in  the  dialog  box  that  appears  when  the 
‘Tile”  option  is  selected  To  close  the  “Print  Header"  window,  click  the  “Exit”  button. 


(nr  r.Mt 


Figure  14.  Print  Header  Ou^t  Selection  \i^clow 
33.4.3.5  PRODUCTS:  Print  Log  (MDBA  Only) 

The  “Print  Log”  window,  Figiro  15,  is  available  to  the  MDBA  user  account  only.  It 
a[^)ears  when  the  ‘Trint  Log”  menu  item  is  selected  from  die  ‘Troducts”  pull-down  menu.  The 
“Print  Log”  window  produces  a  listing  of  historical  infcxrmation  abcnit  actions  that  have  been 
poformed  cm  the  MOODS  database  using  the  MDMS.  The  scrollable  ‘Tunctiems”  textbox  allows 
you  to  focus  on  the  history  of  specific  operations  and  procedures;  e.g.,  “IMPORT”, 
“CREATE_TABLE”,  “DATE_CLASS”.  Only  erne  fimetion  may  be  selected  at  a  time.  Text  entry 
boxes  permit  entry  of  userid  names  and  minimum  and  maximum  dates.  The  default  userid  name  is 
the  wildcard  **’  (all  usms)  and  the  date  defaults  are  1  January  of  die  current  calendar  year  (“Min 
Date”)  through  the  current  date  (“Max  Date”).  After  choosing  a  function  and  mo^hfying  “Name”, 
‘Min  Date”  and  “Max  Date”  tex^xes  as  desired,  the  MDBA  may  select  amcmg  ‘Tile”,  “Printer”  or 
“Screen”  as  the  ouQmt  target  by  clicking  one  of  the  diamond-shaped  buttons  adjacent  to  the 
respective  labels.  Once  these  options  have  been  defined  to  the  MDMS,  clicking  the  “Ok”  button 
executes  the  options.  If  the  “File”  option  is  selected,  the  historical  data  will  be  printed  to  the  text 
file  “moods_log.dat”  in  the  current  directory.  The  file  “moods_log.dat”  is  overwritten  by 
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subsequent  output  of  log  information  to  the  file  -  it  is  not  appended.  If  you  have  selected  the 
“Screen”  tuition  for  ouqnit,  a  text  window  (see  Figure  16)  will  display  the  log  data  pertinent  to  the 
fiinctitm,  user  and  date  range  selected  in  die  “Print  Log”  window.  To  close  the  text  window,  select 
“Close”  from  the  X-Win<tows  unlabeled  pull-down  menu  located  in  the  upper  left  comer  of  the 
window  border.  If  you  have  selected  “Printer”  as  die  output  target,  the  information  will  be  dumped 
to  the  default  printer.  The  status  of  your  request  via  the  “PMt  Log”  window  is  printed  in  the 
“Messa^”  textbox  in  the  lower  left  portion  of  the  “Print  Log”  window.  The  ‘Tieset”  budon  may  be 
used  to  deselect  any  ftmctions  and  return  the  “Name”,  “Min  Date”  and  “Max  Date”  text  windows  to 
dieir  original  default  values.  Whra  finished,  click  die  “Done”  button  to  return  to  the  MDMS  main 
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Figure  IS.  Print  Log  Definition  Window 


Figure  16.  Print  Log  Screen  Ouqnit  Example 
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33.4.3.6  PRODUCTS:  Page  Summary 

TTie  “Page  Summary”  output  selection  window.  Figure  17,  appears  when  the  “Page 
Summary”  menu  item  is  selected  from  the  'Products”  pull-down  menu.  This  window  presets 
diamond-shaped  buttons  for  selecting  either  “Screen”,  “Printer'’  or  “File”  as  tiie  output  target  Only 
one  option  may  be  selected  at  a  time.  After  selecting  die  output  target,  click  the  “Ok”  button  to 
produce  a  listing  of  page  summary  on  die  target  ou^t  device.  If  “Screen”  is  the  selected  option, 
ou^Hit  is  directed  to  a  text  window  on  screen  (see  Figure  18).  The  header  display  window  may  be 
closed  by  selecting  its  “Close”  option  from  the  X-Windows  unlabeled  pull-down  menu  located  in 
the  upp^  left  comer  of  the  window  border.  The  text  window  display  contains  output  from  the 
UNIX  “vi”  editor.  It  responds  to  all  “vi”  commands.  If  “Printer”  is  die  selected  option,  a  paper 
[mtout  of  the  summary  information  is  produced  by  the  default  printer.  To  ensure  printout  of  full 
lines,  the  default  printer  should  be  citable  of  136  character/line  output.  If  “File”  is  the  chosen 
option,  the  header  information  is  written  to  a  user  specified  file  as  defined  in  the  dialog  box  that 
t^ipears  when  die  “File”  option  is  selected-  To  close  die  “Page  Summary”  window,  click  the  “Exit” 
button. 


Ok  flxit 


Figure  17.  Page  Summary  Definiticm  Window 
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Figuie  18.  Page  Summary  Screen  Output  Example 


3.3.4.4  UTIL 

The  “UTIL”  pull-down  menu  currently  provides  options  for  users  to  initialize  or  save 
“Selection  Status”  settings  from/to  a  file. 

3.3.4.4.1  UTIL:  Read  Defaults  FUe 

When  clicked,  the  ‘Read  Defaults  File”  menu  item  opens  a  window  (Figure  19)  for  entry  of 
a  filename.  Tlie  named  file  must  conform  to  the  initialization  (default)  format  described  in 
Appendix  C.  When  “Load”  is  clicked,  values  contained  in  the  file  replace  existing  values  in  the 
“Selection  Status”  area,  successful,  the  “REMARK”  textbox  will  contain  the  message  “New 
Defaults  File  Loaded”.  If  unsuccessful,  the  “REMARK”  textbox  will  respond  witfi  “Error  reading 
Defaults:  aearing  Defaults”.  To  close  Ae  “Read  Defaults  File”  window,  click  die  ‘Rxit”  butUm. 
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Figure  19.  Util  Read  Defaults  File  Window 


33.4.4.2  UTIL:  Write  Defoults  File 

When  clicked,  die  “Write  Defaults  File”  menu  item  opens  a  window  (Figure  20)  for  entry 
of  a  filename.  Whra  'XDk”  is  clicked,  the  named  file  is  created  and  the  current  values  of  “Selection 
Status”  textboxes  ate  written  to  the  file  in  the  initialization  (default)  file  format  described 
AppradU  C.  This  features  permits  users  to  save  initialization  parameter  settings  for  reuse, 
successful,  the  “REMARK”  textbox  will  contain  the  message  “Written  To  File”.  If  unsuccessful, 
the  “REMARK”  textbox  will  inform  of  die  reason  for  the  failure. 


Hguie  20.  Util  Write  Defaults  Rle  Window 


3.3.4.5  HELP 

The  “Help”  pulldown  menu  offers  on-line  assistant  to  the  user.  Help  is  available  on 
M(X)DS  software  procedures  and  techniques  from  the  menu  items  that  appear  when  the  ‘Tlelp” 
menu  header  is  selected.  Help  on  each  subject  is  ^vided  in  a  series  of  pop-up  help  screen 
windows  that  aj^iear  in  response  to  menu  item  selection.  When/if  additional  help  is  available,  it 
may  be  accessed  by  dicing  the  “Help”  button  located  in  the  lower  right  comer  of  a  help  screen. 
To  close  a  he^)  screen,  click  the  “Ok”  button,  located  in  its  lower  left  comer. 
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3.3^  REMARKS 


The  Iniff-colored  “Remark”  textbox  is  located  in  the  lower  left  comer  of  the  display 
window.  The  “Remark”  textbox  provides  notification  of  errors,  event  status  and  communicates 
instmctions  for  follow-on  interaction  by  the  user. 

3.4  Using  the  MOODS  Data  Management  System 

The  previous  subsection  (3.3)  of  this  manual  describes  the  screoi  displays,  windows,  and 
tire  functional  mechanics  required  to  operate  the  MDMS.  This  subsectimi  discusses  operational  use 
of  die  MDMS.  MOODS  is  an  exceptionally  large  database.  To  (^>timize  performance,  the  database 
has  bear  {diysrcally  partitioned  into  10  public  (unclassified)  geographical  r^mis  and  4  restricted 
geogr^hic^  regions.  Each  regional  domain  ctmtains  the  M(X)DS  data  for  all  years  within  that 
domain.  Logically,  the  MDMS  projects  a  seamless,  integrated  view  of  the  M(X)DS  database  tiiat 
hides  the  underlying  physical  structure. 

3.4.1  MDMS  Features 

The  MDMS  is  the  user  “ftont  end”  for  the  NAVOCEANO  MOODS  database.  It  enables 
access  to  the  MOODS  database  by  authorized  users  and  suj^xxts  the  database  management  and 
control  functions  vested  in  the  MDB  A.  The  MDMS  supports  database  queries,  data  ingestion  and 
extractimi,  data  visualization,  user  help  and  error  reporting.  For  the  MDBA,  the  MDMS  sui^rts 
maintenance  of  query  criteria  and  historical  records.  Button  labels  for  MDBA-only  features  are 
inactive  when  other  users  execute  tiie  MDMS. 

3.4.1.1  Database  Queries 

Most  MDMS  features  involve  a  database  query  as  the  initial  process.  Consequently,  the 
opening  MDMS  display  has  been  designed  for  interactive  construction  of  database  queries. 
MDMS  queries  ate  based  <m  parameters  contained  in  MOODS  profile  headers.  The  minimum  and 
maximum  values  of  10  parameters  must  be  initialized  before  the  MDMS  executes  a  database  query; 
otherwise,  an  error  message  will  be  sent  to  the  “Remarks”  textbox  by  MDMS  procedures  that 
involve  a  database  qu^.  The  10  query  parameters  are  displayed  in  tiie  “Selection  Status”  section 
of  the  main  MDMS  display.  Except  for  Latitude  and  Longitude,  minimum  and  maximum  query 
parameters  may  be  set  to  the  same  value.  Query  parameters  may  be  initialized  manually  or  by 
reading  a  default  file.  A  (hoabase  query  does  not  occur  until  tiie  user  selects  an  MDMS  option  th^ 
requires  a  search  for  data. 

3.4.1.1.1  Manual  Initialization  of  a  Database  Query 

Latitude  and  Longitude  limits  are  defined  in  tiie  ‘REGION  SELECTION'’  window  which  is 
accessed  throu^  tte  “Regicai”  buttcni  of  tiie  “SELECT”  pulldown  mrau.  *111116  limits  are  defined  in 
tiie  “TIME  SELECTION”  window  which  is  accessed  through  the  “Time”  button  of  tiie  “SELECT’ 
pulldown  menu.  The  remaining  7  parameters  are  initialized  by  the  “Data  Selectioi”  portion  of  the 
main  display,  as  either  a  minimum  or  maximum  value,  in  accordance  with  the  status  of  the 
“Minimum”  and  “Maximum”  toggle  butUms  in  the  “Selection  Status”  portion  of  the  main  display. 
Manual  parameter  initialization  may  be  accomplished  in  any  order.  Existing  values  may 
modified  and  remodified  witiiin  tiie  constraints  of  Ae  “Data  Selection”  chsplay. 


3.4.1.1.2  Using  Parameter  Initialization  Files 

When  the  MDMS  is  launched  by  entering  moods  at  the  UNIX  command  line,  the 
application  automatically  lo(^  for  die  “moiods-defaults”  file  in  the  cuirrait  diiectoiy.  There  are  two 
ad^onal  options  for  setting  query  parameters  using  parameter  initializatitxi  files: 

a.  From  the  command  line,  rater  moods  -f  filename.  The  flag  “-f”  tells  the  MDMS  that 
the  next  argument  (‘Tilraame”)  is  the  name  of  a  tile  to  use  instead  of  “moods.defaults”.  The  “-r 

is  the  only  flag  cunrady  implemented  by  the  MDMS. 

b.  By  entering  the  name  of  a  parameter  initialization  file  into  the  dialog  box  which  appears 
whra  die  ‘‘Read  Defaults  File”  buttra  is  selected  from  the  “UTIL”  pulldown  menu.  This  option 
allows  die  user  to  implement  an  alternate  parameter  initialization  tile  from  within  the  application, 
dieieby  obviating  the  need  to  exit  from  the  MDMS  m  do  so. 

Parameter  initialization  files  may  be  created  by  saving  existing  parameter  values.  This  is 
accomplished  by  clicking  the  “Write  Defaults  File”  button  under  the  “UTEL”  pull-down  menu, 
ratming  die  tilraame  and  clicking  “Gif’  to  create  the  file. 

3.4.1.2  Importing  Data  (MDBA  Only) 

The  MOODS  data  import  function  is  reserved  for  MDBA  use  only.  A  database  query  is  not 
necessary  for  data  import  It  is  important  to  note  that  repetitive  import  of  the  same  d^  file 
produces  duplicate  data  in  the  MOODS  database.  The  existence  of  duplicate  profiles  in  MOODS 
may  require  database  cleanup  by  the  MDBA  using  direct  SQL  commands  to  die  ^press  rdbms 
engine.  The  only  criteria  available  for  differentiating  between  duplicate  MOODS  profiles  may  be 
the  unique  loading  date  assigned  to  each  profile  when  imported  into  the  database.  To  be  ii^rted, 
data  must  be  in  dw  MOODS  ADMIN  format;  otherwise  an  error  will  be  reported.  Importing  data 
has  no  effect  on  parameter  settings  within  the  main  MDMS  display.  Imported  is  sorted  by 
region  before  ingestion  into  the  darabase. 

3.4.13  Exporting  Data 

Within  classification  crastraints,  all  users  may  extract  MOODS  data  to  a  file.  The  data  to  be 
edited  is  determined  by  die  parameter  ran^  setting  in  the  “Selectira  Status”  sectira  of  the  main 
di^ilay.  The  database  query  occurs  ^ira  the  “Doi»”  button  is  clicked  after  ratering  die  output  file 
name.  All  MOODS  pn^es  widi  header  infoniuUira  falling  within  the  boundary  criteria  displayed 
in  die  “Selection  Status”  display  will  be  written  to  the  nan^  file.  Subsequent  exports  to  the  same 
file  will  overwrite  any  previous  output;  Le.,  exported  data  is  not  appended  to  the  file. 

3.4. 1.4  Updating  Parameter  Selection  Tables  (MDBA  Only) 

The  MDBA  may  add,  delete  or  modify  classification  codes,  instrument  types  and  source 
codes  through  die  “Update  Table”  optimi  of  tte  “MDBA”  pulldown  menu.  Numerical  codes  and 
descriptiras  are  not  preset  by  the  MDMS.  Each  parametra  (Class,  Instrument  ID  and  Source)  is 
treated  as  a  separate  entity  in  the  “Update  Table”  submenu;  however,  procedures  are  much  the 
same  for  each.  A  deleted  parameter  value  is  immediately  removed  from  the  parameter  listbox. 
Whra  added,  a  new  parameter  value  is  initially  appended  to  the  listing;  however,  in  subsequent 
accesses  to  die  parameter  update  window,  the  new  parameter  value  appears  properly  inserted 
within  die  listing.  The  numraical  idratificatira  codes  and  die  informative  text  associated  widi  diem 
may  be  edited  as  separate  ratifies,  evra  though  each  lisdxix  line  contains  bodi  die  code  and  die  text 
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3.4.1^  Viewing  the  Data  Distribution 

The  **PRODUCTS”  pulldown  menu  supports  visual  examinaticm  of  MOODS  data  as  a 
histogram  plot,  a  geographical  location  plot,  or  a  parameter  versus  depdi  (profile)  plot.  Each  plot 
proc^lme  requires  a  database  query  to  establish  the  data  contrat  to  be  f^ott^ 

3.4.1.5.1  Frequency  (Histogram)  Distribution  Plot 

The  MOODS  histogram  provides  an  easily  interpreted  visual  represratation  of  tl^  results  of 
a  MOODS  (bdabase  query.  It  is  a  S-dimensimial  i^ot  (see  Figure  13),  one  of  two  c^tms  available 
in  die  *T>istribution  Plot”  window  aiiich  appears  whoi  the  'TRODUCTS:  Distribution”  mniu  item 
is  clicked.  The  base  dimensions  of  the  histogram  plot  are  subdivided  into  a  grid  whose  mesh 
distance  is  set  by  entering  the  ‘"Latitude”  and  "l/xigitude”  parameters  in  the  “Distribution  Plot” 
window.  Tbe  vertical  dimensi<xi  represrats  the  number  of  profiles  found  to  lie  within  each  cell  of 
the  grid.  Histogram  ouqut  may  be  sent  to  the  screra  or  to  a  printer. 

3.4.1.5.2  Geographical  Distribution  Plt^ 

The  MOODS  geographical  distribution  plot  displays  die  spatial  distribution  of  ^files 
found  by  a  MOODS  datal^  query.  It  is  one  of  three  options  available  in  the  “Distribution  Plot” 
definition  window  which  appears  in  response  to  clicking  the  ‘TRODUCTS;  Distribution”  mrau 
item.  In  the  geografdiical  plot,  each  profile  is  represented  by  an  instrument  ty^  symbol  at  the 
proper  geogra[^ic  location.  The  size  of  die  symbol  is  determined  in  the  “Distribution  Plot” 
window.  The  btitude  and  longitude  boundaries  of  the  plot  are  diose  defined  in  the  “Selection 
Status”  portion  of  the  main  display.  Grid  coordinate  distances  are  determined  by  the  “Latitude” 
and  ‘Txmgitude”  parameters  defined  in  the  “Distriinition  Plot”  window.  Geographical  distributimi 
charts  may  be  sent  to  tte  screai  or  to  a  printer. 

3.4.1.5.3  Accumulation  Distribution  Plot 

The  accumuladon  plot  is  idratical  to  the  get^raphical  distribution  {dot  with  the  addition  of  a 
printed  count  of  die  number  of  profiles  within  each  ladtude/longitude  box  of  the  grid. 

3A1.5.4  Depth  Vs.  Parameter  Plots 

The  depth  vs.  parameter  (profile)  plot  is  a  common  mediod  of  displaying  oceanogra{^c 
data.  The  vertical  plot  axis  is  scaled  for  depth  rei»esentation  (meters)  and  the  horizontal  axis  is 
scaled  for  units  of  ^  sdected  parameter.  The  MDMS  provides  the  capability  to  construct  d^Mh  vs. 
parameter  [dots  cf  temperature,  salinity  and  sound  spe^  •  the  diree  primary  parametaRs  depicted  in 
MOODS  profile  da^  These  [dots  are  available  by  clicking  the  ‘Depdi  Vs  Parm”  menu  item  under 
die  “PRODUCTS”  moiu  and  selecting  either  ‘Temperature”,  “Salinity”,  or  “Sound  Speed”  as  the 
parameter  of  choice.  For  each  parameter,  a  window  appears  offering  nuxtifiable  default  values  for 
X-  and  y-axis  ranges  and  the  maximum  allowable  number  of  proves.  When  the  “Ok”  button  is 
clicked,  the  database  is  queried.  Then,  a  graphics  window  displays  die  plot  as  a  group.  There  is 
usually  considerable  overlap  amoag  Ae  plrdted  profiles.  Proves  which  do  not  cmiform  to  the 
bdiaviOT  troid  di^layed  by  most  of  die  profiles  are  easily  recognized  due  to  their  errant  traces. 
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3.4.1.6  Query  Criteria  Maintenance  (MDBA  only) 


The  MDBA  is  re^pcxistble  for  maintaining  the  accuracy  of  key  parameters  used  in  querying 
the  MOODS  database.  CMy  the  NODBA  can  exercise  all  MDMS  features.  The  MDMS  {Hovides 
editing  services  for  the  MDBA  that  support  changes  to  classification  codbs,  instrument  types  arul 
source  codes.  New  values  for  these  query  piuameters  can  be  added,  and,  (Mitdated  values  can  be 
delved  or  modified.  These  services  are  available  dirough  the  “Update  Table”  menu  item  of  the 
“MDBA”  pi^-down  menu.  Care  must  be  taken  in  making  query  criteria  decisions  that  could  affect 
the  accessibility  of  MOODS  data.  This  is  pa^cularly  important  for  the  classification  parameter 
which  controls  usmr  access  to  the  MOODS.  It  is  ccmceivable,  but  not  likely,  that  an  error  in  criteria 
maintenance  could  produce  data  that  cannot  be  qu^ied. 

3.4.1.7  Transaction  History  (MDBA  only) 

It  is  vital  to  maintain  records  of  data  transactions  that  affect  the  state  of  the  MOODS 
database.  The  MDMS  maintains  a  small,  separate  transaction  logging  database  that  records  key 
informatioa  conceiting  actions  performed  on  the  database  by  all  users.  This  feature  equips  die 
MDBA  with  a  modest  degree  of  investigative  capability.  The  MDBA  can  focus  queries  to  the  log 
database  on  sin^e  MDMS  fimctieis,  individual  users  or  date  ranges.  The  ouqxit  can  be  sett  to  tte 
screen,  die  printer  or  a  file.  The  logging  services  axe  available  to  die  MDBA  from  die  “Print  hog” 
moiu  item  under  die  ‘Troducts”  pull-down  moiu. 

3,5  Example 

This  example  demonstrates  how  to  set  up  die  opening  display,  read  data  from  a  file,  write 
data  to  a  file,  and  viewing  data. 

3,5.1  Setting  Up  the  Opening  Dbplay 

Getting  Started: 

1.  At  die  system  pnmipt,  type  “moods”.  The  MOODS  opening  display  screen  will  ai^iear 
(Hguie  1).  All  information  is  provided  from  the  default  window  but  if  you  prefer  to  edit  continue 
witt  diis  example. 

Setting  R^on  and  Time: 

2.  Qick  the  “Select”  pull-down  menu  header.  Then,  select  die ‘^Region”  menu  itenL  The 
r^on  setectitm  window  (jPigim  2)  will  a{^^.  Either  use  the  rubberband  technique,  select  from 
the  list  of  predefined  regions,  or  ettit  the  re^on  coordinates  from  the  keyboard.  Close  die  window 
by  clicking  the  “E^e”  Initttm,  then  die  “Exit”  button.  The  regicm  modifications  will  appear  in  the 
“Selection  Status”  porticm  of  die  “Main  Window”  display. 

3.  Click  the '‘Select”  pull-down  menu  header.  Then,  select  the ‘Time”  menu  item.  The 
time  selection  window  figure  3)  will  appear.  Qick  the  “Start”  button  to  change  the  start 
(minimum)  date  and  time.  Click  the  “End”  buttmi  to  change  the  end  (maximum)  date  and  time. 
After  desir^  changes  have  beat  made,  click  die  “Exit”  button.  The  time  and  date  modifications 
will  iqipear  in  die  “Selection  Status”  portion  of  die  “Main  Window”  ^play. 
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Setting  Classification  Codes,  Cruise  Identification  Numbers,  Load  Dates, 

Instrument  Types,  Months,  Number  of  Parameters,  and  Source  Code: 

4.  Click  die  “Minimum”  or  “Maximum”  buttcm  lcx:ated  on  the  “Selection  Status”  window. 

5.  Select  one  of  die  minimum  (maximum)  classification  codes  listed  in  the  “Data  Sdection” 
window.  If  the  desiied  code  is  not  visible,  use  the  scroll  bar  to  examine  the  remaining 
classification  codes.  The  modifications  will  appear  in  die  “Selection  Status”  portion  of  the  “Main 
Window”  display. 

6.  Move  the  cursor  to  the  textbox  labeled  ^Chiise  Id”  and  click  the  mouse  button  to  activate 
it  From  the  keyboard,  enter  the  minimum  (maximum)  value  desiied  for  the  cruise  ictentification 
number.  The  modificatitxis  will  appear  in  the  “Selection  Status”  portion  of  die  “Main  Window” 
display. 

7.  Move  the  cursor  to  the  textbox  labeled  “Load  Date”  and  click  the  mouse  button  to 
activate  it  From  the  keyboard,  enter  the  minimum  (maximum)  desired  load  date.  The 
modifications  will  ai^iear  in  the  “Selection  Status”  portion  of  die  “Main  Window”  disjday. 

8.  Select  one  of  die  minimum  (maximum)  instrument  types  from  those  listed  in  die  lisdiox 
labeled  “Instrument  Type”  in  the  “Data  Selection”  window,  the  desired  instrument  type  is  nm 
visible,  use  the  scroll  bar  to  examine  the  remaining  instrument  types.  The  modifications  will 
appear  in  the  ‘^lectkxi  Status”  portimi  of  die  “M^  Window”  disfi^y. 

9.  A  minimum  (maximum)  mondi  may  be  d^ennined  during  the  time  selectimi  procedure 
in  step  3,  above.  If  time  selection  was  skipped,  die  minimum  (maximum)  mmith  may  be  selected 
from  die  texdiox  labelled  “Month”.  If  the  desired  month  is  not  visible,  use  the  scroll  bar  to 
examine  the  remaining  months.  Modifications  to  die  mmith  will  aj^iear  in  the  “Selection  Status” 
portion  of  die  “Main  Window”  display. 

10.  To  select  the  number  of  parameters,  manipulate  the  sliding  bar  labelled  “Number  of 
Parameters”.  The  numbo:  above  the  sliding  bar  will  change  as  die  sliding  bar  is  moved,  and  the 
minimum  (maximum)  numba  of  parametm  will  ai^iear  in  the  “Selection  Status”  portion  of  die 
“Main  WiiKlow”  disftoy. 


1 1.  Select  a  minimum  (maximum)  source  codes  from  those  listed  in  the  listbox  labelled 
“Source  G>de”.  If  the  desired  source  code  is  not  visible,  use  the  scroll  bar  to  examine  the 
remaining  choices.  Modifications  to  minimum  (maximum)  source  codes  will  appear  in  the 
“Selection  Status”  portion  of  the  'Main  Window”  di^lay. 

The  opening  window  is  now  set  up. 

3,5,2  Reading  Defiiults  Data  firom  a  File 

FbUow  these  steps  to  read  default  data  from  a  file. 

1.  Click  die  “Util”  menu  header. 

2.  Click  the  “Read  Defaults  Fite”  menu  item. 
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3.  Enter  the  desired  file  name  in  die  textbox  from  the  keyboard.  Then,  click  the  “Load”  and 
“Exit”  buttons  (in  tfiat  order). 

Or.  omtinue  widi  these  steps: 

4.  Select  a  direct(»y. 

5.  Select  a  file. 

6.  Click  die  *Tx>ad”  and  Exit”  buttons  (in  diat  order). 

3.53  Writing  Defaults  Data  to  a  File 

Follow  these  steps  to  write  data  to  a  file. 

1.  Click  die  “Util”  mom  header. 

2.  Click  the  **Write  Defaults  File”  menu  item. 

3.  Enter  die  desired  file  name. 

4.  Click  “Ok”. 

5.  CUck“Exit”. 

4  ERROR  MESSAGES 

MOODS  error  messages  are  displayed  in  the  “Remaiics”  textbox  within  the  MOODS 
opening  display  window.  Eir^  are  reported  when  a  selected  dataset  cannot  be  found  within  the 
M(X)DS  dabb^  or  vAien  an  atteII^)t  is  made  to  perform  an  illegal  procedural  action. 

5  NOTES 

5.1  Glossary 

See  the  glossary  ctmtained  in  Appendix  A  for  definitions  of  key  terms  used  in  this 
docummL  Also,  see  de^itions  giv^  in  S^on  13.3. 

5.2  Abbreviations  (acronyms) 

See  the  listing  of  acronyms  in  Appoidix  B  fm:  definiticms  of  all  relevant  acronyms. 

53  System  Considerations 

The  MDMS  is  intended  for  installation  in  and  execution  by  Sun  Microcomputers, 
Incorporated  collating  platforms.  Installati<xi  is  site  specific  and  tailorable  to  the  environment. 
Appendix  F  provides  ir^mmaticHi  specific  to  installation  of  the  MDMS  within  die  NAVOCEANO 
computing  environment  The  MDMS  may  be  executed  from  an  X-terminal;  however,  some 
grai^cal  screens  within  the  MDMS  ate  memory  intensive  and  will  cause  termination  of  the 
sofnvaie  if  available  X-tenninal  memory  is  exceeded. 
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5.3.1  System/Software  Requirements 

Tbe  MDMS  is  an  integrated  software  system  that  i^uires  the  presence  of  both  specific 
commercial  off-the-shelf  software  and  govemment-provid^  software.  While  the  details  of 
integrated  software  item  requirements  are  provided  in  Appradix  E,  the  following  general  comments 
apply. 

(1)  The  MDMS  was  designed  for  execution  under  control  of  the  UNIX  operating 
system  oa  Sun  Microsystems  hardware. 

(2)  The  MDMS  requires  the  presence  of  the  X- Windows  client-server  environment 

(3)  The  Open  Software  Foundation’s  (OSF)  Motif  Toolkit  (library)  must  be  present 
and  available  in  the  execution  environment 

(4)  A  runtime  version  of  UNIRAS  ag/X  Toolmaster  software  must  be  installed  on 
the  system  and  available  in  the  execution  environment  to  support  MDMS  gra^^cal  display  options. 

(5)  The  Empress  relational  database  engine  must  be  installed  on  the  system  and 
available  for  execution  as  the  vehicle  for  accessing  data  attained  in  the  MDMS  database. 

(6)  The  Naval  Environmental  Operational  Nowcast  System  (NEONS)  must  be 
installed  as  the  functional  database  model  and  lil»aiy  of  database  access  tools. 

(7)  Of  interest  to  programmers,  the  software  code  for  this  version  of  the  MDMS 
was  compiled  using  C  and  Fortran  compilers  suj^lied  by  Sun  Microsystems,  Incorporated. 

(8)  The  MDMS  is  an  interactive  application.  It  incorporates  standard  X-Windows 
mouse  and  keyboard  functions.  See  Section  2  for  references  that  explain  X-Windows  procedures 
and  terminology  in  greater  detail. 

5.3.2  IRrectory  Map 

MDMS  software  executables  have  been  designed  to  execute  via  the  following  directory 

paths: 

MDMS:  /u/a/moodsdba/moods/src 

NEONS:  /u/aAnoodsdbaAsdb.iltn 

Empress:  /usr/local/empress/v6.2 

UNIRAS  ag^  Toolmaster:  /usr/local/uniras/6v3a/base 

X-Windows  (X11R5):  /usr/local/XllR5pl2 

OSF  Motif:  ^sr/^b 

These  paths  mu^  be  defined  in  the  individual  user’s  login  and/or  shell  scripts  for  execution  upon 
logging  into  die  system  and  modified  if  system  ccmfiguration  is  changed. 

5.3.3  Security 

The  MDMS  neither  supports  nor  restricts  the  overall  classification  of  the  computing 
environinait;  however,  classification  codes  are  contained  in  die  header  information  of  each  profile. 
The  MDB  A  controls  access  to  MOODS  data  by  audiori^g  classification  code  access  to  each  user. 
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Appendix  A 
Glossary  of  Terms 

bathymetric  Of  or  pertaining  to  the  depth  of  the  ocean. 

ingestion  The  procedure  whereby  data  is  translated  and  transferred  from  an  exterior  format  and 
placed  within  the  MOODS  database  for  access  under  control  of  the  MDMS. 

Julian  The  day  of  the  year  according  to  the  Julian  calendar  which  begins  on  January  1.  A  Julian 
date  does  not  include  a  year  as  part  of  its  simple  format. 

metadata  Information  about  a  dataset,  either  descriptive  or  defmitive  as  to  quantity,  quality, 
quantity  or  format 

profile  A  sequential  listing  of  parameters  keyed  to  a  reference  structure.  A  bathymetric  profile 
contains  sequential  depth/parameter  groups. 

zoom  The  graf^ical  scaling  process  whereby  a  screen  display  item  is  expanded  or  decreased  in 
size. 
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Appendix  B 
List  of  Acronyms 


CAST  -  Center  for  Air  Sea  Technology 
CDRL  -  Contract  Data  Requirements  List 
DiD  -  Data  Item  Descriptkm 
D(£)  -  Department  of  Defense 
E-east 

GUI  -  graphical  user  interface 
Lat- latitude 
Lon  -  longitude 
max  -  maximum 

MDB  A  -  MCX)DS  Database  Administrator 
MDMS  -  Moods  Data  Management  System 
min  -  minimum 

MCXIDS  -  Master  Oceanographic  Observation  Data  Set 
MSU  -  Mississippi  State  University 

mwmrc  -  “Motif  window  manager”,  an  X-Win<tows  window  manager 
N  -  north 

NAVOCEANO  -  Naval  Oceanograifiic  Office 

NEONS  -  Naval  Envinmmental  Operational  Nowcast  System 

OSF  -  Open  Software  Foundation 

S  -  south 

twmrc  -  ‘Tom’s  window  manager”,  an  X-Windows  window  manager 
W  -  west 


B-1 


Appendix  C 
User  Default  File 

Default  values  for  parameters  appearing  within  the  “Selection  Status”  textboxes  of  the 
MDMS  main  display  may  be  maintained  in  a  user-created  default  file.  The  user  may  specify  the  file 
ctMitaining  default  values  by  including  die  “-f  ’  flag,  followed  by  the  filename,  when  launching  the 
MDMS  (example;  moods  -f  myfile).  If  the  default  file  is  not  indicated  on  the  command  line,  the 
MDMS  will  look  for  die  file  “nwods-defaults”  in  the  current  directory.  If  the  “moods.defaulis”  file 
cannot  be  located,  parameter  boxes  within  the  ^‘Selection  Status”  poition  of  the  main  display  will  be 
blank  at  startup.  The  format  for  a  default  file  is  as  follows: 

Latitude  21.3  30.0 

Longitude  -121.0  -109.0 

Date/Hour  19621207:6:0:0  19931008:12:0:0 
Classification  1100010  1 100010 


Month 

3 

3 

Farms 

2 

3 

Cruise-Id 

300 

300 

Instrument 

25 

25 

source 

4 

4 

load-date 

19920616  19920616 

The  values  conttuned  in  a  default  file  are  ordered  in  a  top-to-bottom  sequence  according  to  their 
appearance  within  the  “Selection  Status”  portion  of  die  main  display.  The  format  is  free  form 
except  diat  labels  and  numerical  values  must  be  separated  by  at  least  one  space  and  each  labeled  line 
must  end  in  a  carriage  return.  For  each  labeled  category,  there  are  two  numerical  entries,  a 
minimum  and  maximum  value,  on  each  line.  The  first  numerical  entry  is  the  minimum  value.  The 
second  numerical  value  is  the  maximum  value. 
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Appendix  D 
Data  Formats 


The  MOODS  Admin  Format: 


681051 

35.25 

148. 

1719671219113500 

21818  01100010 

0  16 

2 

2  3 

0  135 

5938 

0 

256  0  109  19880824 

0  19921211 

0 

7248 

21818 

31 

116821818 

31 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0. 

40.00 

10 

17.20 

15. 

17.10 

35. 

17.10 

40. 

17.00 

55. 

85.00 

60 

16.90 

70. 

16.90 

80. 

16.70 

85. 

16.10 

105. 

130.00 

115 

14.50 

120. 

14 .40 

125. 

14.40 

130. 

14.20 

135. 

0.00 

0 

0.00 

0. 

0.00 

0. 

0.00 

0. 

0.00 

681026 

35.10 

146. 

4019641220 

1000 

30073  01100010 

0  5 

2 

2  3 

0  45 

5796 

0 

256  0 

24  19880824 

0  19921211 

0 

7233 

30073 

31 

28M30073 

31 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0. 

45.00 

25 

17.30 

30. 

17.40 

40. 

17.40 

45. 

17.30 

681025 

35.25 

146. 

0519671219173000 

21818  01100010 

0  13 

2 

2  3 

0  135 

5783 

0 

256  0  110  19880824 

0  19921211 

0 

7232 

21818 

31 

117M21818 

31 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0. 

70.00 

50 

14.80 

55. 

14 .70 

65. 

14.70 

70. 

14.80 

75. 

120.00 

80 

14.70 

110. 

14.70 

115. 

14.60 

120. 

14.10 

125. 

0.00 

130 

12.90 

135. 

12.70 

125. 

14.40 

130. 

14.20 

The  IDEAS  Format: 


32.67  131.90  19691202 

20600  25 

4 

3 

80710  1100010 

50 

68AV8  oAV  a 

***** 

10.  17.80  -99.00 

20. 

17.70 

-99.00  30.  17.70 

-99.00 

50. 

17.70 

-99.00 

32.52  131.74  19691205 

1200  25 

4 

3 

80840  1100010 

30 

66T78  oT7  - 

***** 

0.  17.60  34.44 

10. 

17.65 

34.43  20.  17.83 

34 .43 

30. 

17.73 

34.44 

32.52  131.78  19691205 

3000  25 

6 

3 

80840  1100010 

60 

66T78  OT7  - 

***** 

0.  17.75  34.50 

10. 

17.67 

34.50  20.  17.94 

34.49 

30. 

18.12 

34.50 

50.  16.99  34.44 

60. 

17.00 

34.43  0.  0.00 

0.00 

0. 

0.00 

0.00 

32.52  131.85  19691205 

10000  25 

7 

3 

80840  1100010 

90 

105T78  oT7  - 

***** 

0.  17.60  34.46 

10. 

16.59 

34.32  20.  16.94 

34.46 

30. 

17.32 

34.43 

50.  16.50  34.44 

75. 

16.40 

34.43  90.  15.74 

34  .45 

0. 

0.00 

0.00 

32.53  131.91  19691205 

13000  25 

9 

3 

80840  1100010 

130 

206T78  oT7  - 

***** 

0.  18.30  34.52 

10. 

18.12 

34.51  20.  18.43 

34.50 

30. 

18.45 

34.52 

50.  18.32  34.48 

75. 

17.80 

34.48  100,  16.07 

34.50 

125. 

14  .46 

34.49 

130.  14.15  34.49 

0. 

0.00 

0.00  0,  0.00 

0.00 

0. 

0.00 

0.00 

32.28  131.69  19691206 

13000  25 

6 

3 

80840  1100010 

60 

64T78  oT7  - 
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***** 


0.  18.30  34.50  10.  18.21  34.52  20.  18.33  34.52  30.  18.10  34.50 

50.  17.90  34.49  60.  18.00  34.48  0.  0.00  0.00  0.  0.00  0.00 
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Appendix  E 

Commercial  and  Non-Developmental  Software  (NEONS,.  Empress,  UNIRAS, 

X-Windows,  OSF  Motif) 

MOODS  has  been  developed  to  operate  within  a  Sun  Microsystems  SparcStaticai  model  10 
computer  hardware  environment.  The  operating  system  is  SUNOS  version  4.1.3,  including  the 
resident  SUN  C  compiler  which  was  used  to  write  the  MOODS  software  code.  Some  minor 
elements  of  NEONS  have  been  written  in  FORTRAN??  (Sun  FORTRAN??  version  1.4). 
Gravies  sup^rt  is  provided  by  UNIRAS  ag/X  Toolmaster  version  6v3b.  The  RDBMS  engine  is 
Empress  version  6.2.  The  windowing  environment  consists  of  X-Windows  version  XI 1  R5  and 
the  OSF  Motif  widget  set  version  1.3. 
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Appendix  F 

MDMS  Installation  Instructions 


Instructions  for. 

1)  Setting  up  the  user  .cshrc  file. 

2)  Installing  the  MDMS  Datalx^  files. 

3)  Installing  die  NEONS  software  tree. 

5)  Installing  the  MDMS  user  application  resource  files. 

6)  Installing  the  MDMS  user  application  software. 

Files  provided: 

cslirc  -  An  example  user  .cshrc  file. 

db.tar  -  Tar  file  of  the  MDMS  database  files. 

isdb.tar  -  Tar  file  of  die  NEONS  software. 

import_db  -  The  import  script  diat  installs  the  MDMS  database  tables. 

Install  -  The  Install  scri^  that  makes  and  installs  the 

NEONS  software  libraries  and  shells  and  executables. 
app-defaults.tar  -  Tar  file  of  the  MDMS  user  application  restxirce 
files. 

mdms.tar  -  Tar  file  of  the  MDMS  user  application  software. 

SETUP  ENVIRONMENT: 

*  Set  up  a  login  account  as  'mdba'. 

*  Login  as  the  mdba  and  execute  umask  022. 

*  Idradfy  the  directory  padi  for  Empress  version  6.x  (installed). 

*  Idoi^  the  directory  path  for  UNIRAS  ag/X  Toolinaster  (installed). 
Modified  or  overwrite  the  .cshrc  widi  the  cshrc  file  provic^  on  t^. 

*  Set  die  MSPATH  enviroiunent  variable  within  die  .cshrc  file  to  point  to 
die  locatioi  of  Empress. 

For  example,  suppose  Empress  was  installed  in  /usr/empress: 
change  seteiv  MSPATH  ?/empress/v6.2 

to  setenv  MSPATH  /usr/empress/v6.2 

add  $MSPATH/bin  to  path 

set  padi  -  ($pafh  $MSPATH/bin) 

*  Create  a  database  directory  which  will  coitain  the  MDMS  database.  Use 
emixnl^  to  create  die  MDMS  database.  Refor  to  the  Enpress  “Database 
Administrator’s  Guide”  for  syntax. 

Edit  the  tabzero  file  under  die  database  directory,  set  the  database  pomissions 
and  piiviledges  as  required  by  your  security  environmoit. 

For  example,  suppose  your  security  environment  is  unclassified  and  wide 
(poi  to  die  world.  Setting  the  MSDBPERMS,  MSDBDBAPRIVS  and 
MSDBntlVS  Empress  environment  variables  to  the  following  will  make 
your  database  public  to  the  world: 
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MSDBPERMS  -  WR.  WR.  WR 
MSDBAPERTVS  -  dba  dba  user  grant; 

dbadba  alter 

MSDBPRIVS  -  dba  dba  aU  grant; 

dba  public  user 

Refer  to  the  Empress  *T>atabase  Administrator’s  Guide”  for  assistance  in 
customizing  your  database  to  meet  your  security  needs. 

Set  flie  raviionment  variable  NEONS_DB  widiin  die  .cshrc  to  point 
to  this  directoiy, 

change  setrav  NEONS_DB  ?/neons_db 
to  setenv  NEONSJDB  /mdms/db 

Source  die  modified  .cshic  file  to  update  die  MDMS  environment 

Run  the  importjdb  script  to  install  the  MDMS  database  tables. 

*  Create  a  directory  to  hold  the  NEONS  software.  Move  the  isdb.tar  file  to 
that  directory.  Extract  the  NEONS  software  tree  from  the  isdb.tar  file. 

For  example,  suppose  you  wish  to  create  a  NEONS  software  directory  within 
die  existing  directory  padi  /mdms.  Execute  the  following  commands: 

mkdir  /mdms/isdb 
mv  isdb.tar /mdnu/isdb/isdb.  tar 
change  (cd)  to  the  /mdms/isdb  directory 
tar  xvf  i^b.tar 

Set  die  environment  variable  NEONS_SW  widiin  the  .cshrc  to  point 
to  this  directory. 

change  setoiv  NEONS_SW  ?/isdb 

to  seteiv  NEONS_SW  /mdms/isdb 

add  $NEONS_SW/bin  to  patii 

set  padi  -  ($path  $NEONS_SW/bin) 

«  Source  the  modified  .cshrc  file  to  update  die  mdba  environment. 

Run  the  Install  script  to  make  and  ir^tall  the  NEONS  libraries, 
shells  and  executables. 


source  ~nidba/.cshrc 
Install 

♦  Run  test  examples  under  $NEONS_SW/sic/*_ex  to  check  connectivity 
betwera  die  NOMS  database  and  the  NEONS  library  software  routines, 
(optional) 
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♦  Create  an  ‘a^MJefaults’  directory.  Move  the  app-defaults.tar  file  to 
that  directory.  Extract  the  MDMS  application  resource  files  from 
the  app-defaults.tar  file. 

For  example,  sup^se  you  wish  to  create  an  app-defaults  directory  under 
die  mdba  home  directory:  Execute  the  following  commands: 

mkdir  ~mdba/app-defaults 
mv  app-defaults.tar  ~mdba/app-defaults 
change  (cd)  to  the  -mdba/app^faults  directory 
tar  x^  ai^defaults.tar 

Then,  set  the  environment  variable  XAPPLRESDIR  within  the  .cshrc  to 
point  to  this  directory. 

change  setenv  XAPPLRESDIR  ?/a{^)-defaults 

to  setenv  XAPPLRESDIR  ~m(fi>a/app-defaults 

♦  Create  a  MDMS  application  directory.  Move  the  mdms.tar  file  to 
that  directory.  Extract  the  MDMS  application  software  tree  from 
the  mdms.tar  file. 

For  example,  suppose  you  wish  to  create  a  MDMS  application 
directory  under  /appl: 

mkdir  /appl/mdms 
mv  mdms.tar/appl/mdms/mdms.taT 
change  (cd)  to  the  /appl/mdms  directory 
tar  xvf  mdms.tar 

Then,  make  an  executable  of  die  MDMS  application. 

move  (cd)  to  the  /appl/mdms/src  directory  and  execute  die  command 
make. 

Thra,  update  the  mdba  .cshrc  file  to  include  the  path  to  the  MDMS 
executable. 

add  /a[^l/mdms/src  to  the  path 

set  path  -  ($path  /appl/mdms/sic) 

♦  Source  the  modified  .cshrc  file  to  update  the  mdba  environment 

source  '-mdba/.cshrc 

MDMS  INSTALLATION  AND  ENVIRONMENT  SETUP  SHOULD  NOW  BE 
COMPLETED  -  If  all  went  well! 
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